Skip to content

docs(spec): review and strengthen v6 spec consistency#753

Merged
kys0213 merged 2 commits intomainfrom
docs/spec-evaluator-tick-order
Apr 9, 2026
Merged

docs(spec): review and strengthen v6 spec consistency#753
kys0213 merged 2 commits intomainfrom
docs/spec-evaluator-tick-order

Conversation

@kys0213
Copy link
Copy Markdown
Owner

@kys0213 kys0213 commented Apr 9, 2026

Summary

v6 스펙 리뷰 결과 발견된 Critical 이슈 5건 + Cross-Document 일관성 이슈 3건을 수정.

DESIGN.md

  • Evaluator tick 순서 다이어그램 추가 (collect→evaluate→advance→execute→cron)
  • "Evaluate before Execute" 원칙의 의미 명시 (slot 해제 → 새 아이템 진입)

lifecycle-hook.md

  • Hook impl 동적 로딩 정책 추가 (DB→yaml→생성→실행→해제, LRU 캐시)
  • Hook 에러 처리 정책 추가 (on_enter/on_done=치명적, on_fail/on_escalation=비치명적)
  • on_escalation→on_fail 호출 순서 명시

daemon.md

  • Dependency Gate 에지 케이스 정의 (순환 의존 DFS 탐지, orphan, Failed/Skipped 차단)

datasource.md

  • "on_fail script" → "hook.on_fail()" v6 용어 통일

evaluator.md / stagnation.md

  • Phase 2(v7+) 기능에 "v6 범위 아님" 경계 마커 추가

agent-workspace.md

  • claw→agent 네이밍 정리

Test plan

  • 스펙 문서 간 cross-reference 확인
  • 수용 기준 체크리스트 누락 없는지 확인

🤖 Generated with Claude Code

kys0213 and others added 2 commits April 8, 2026 10:14
- DESIGN.md: add "Tick 순서와 Evaluator 위치" section between flow diagram
  and module table, explaining why evaluate-before-execute matters for
  concurrency slot release
- datasource.md: replace v5 "on_fail script" with v6 "hook.on_fail()" (3 places)
- evaluator.md, stagnation.md: add "v6 범위 아님" markers to Phase 2 features
  (ConsensusStage, DriftDetector/DiminishingDetector) and clarify v6 scope

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- lifecycle-hook.md: add dynamic Hook impl loading (DB→yaml→create→execute→release
  with LRU cache), hook error handling policy (critical vs non-critical),
  on_escalation→on_fail call ordering with pseudocode
- daemon.md: detail dependency gate edge cases (cycle detection via DFS at
  registration, orphan→open, Failed/Skipped→blocked, self-dependency→reject)
- agent-workspace.md: fix stale claw→agent naming in rules path priority
  and implementation references

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@kys0213 kys0213 merged commit 7ac3b11 into main Apr 9, 2026
4 checks passed
@kys0213 kys0213 deleted the docs/spec-evaluator-tick-order branch April 9, 2026 00:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant